home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3g / bgets.z / bgets
Encoding:
Text File  |  2002-10-03  |  4.7 KB  |  67 lines
  1.  
  2.  
  3.  
  4. bbbbggggeeeettttssss((((3333GGGG))))                                                            bbbbggggeeeettttssss((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _bbbb_gggg_eeee_tttt_ssss - read stream up to next delimiter
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _cccc_cccc [_f_l_a_g ...] _f_i_l_e ... _----_llll_gggg_eeee_nnnn [_l_i_b_r_a_r_y ...]
  13.  
  14.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_llll_iiii_bbbb_gggg_eeee_nnnn_...._hhhh_>>>>
  15.  
  16.      _cccc_hhhh_aaaa_rrrr _****_bbbb_gggg_eeee_tttt_ssss _((((_cccc_hhhh_aaaa_rrrr _****_b_u_f_f_e_r_,,,, _ssss_iiii_zzzz_eeee______tttt _c_o_u_n_t_,,,, _FFFF_IIII_LLLL_EEEE _****_s_t_r_e_a_m_,,,,
  17.           _cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_b_r_e_a_k_s_t_r_i_n_g_))))_;;;;
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      _bbbb_gggg_eeee_tttt_ssss reads characters from _s_t_r_e_a_m into _b_u_f_f_e_r until either _c_o_u_n_t is
  21.      exhausted or one of the characters in _b_r_e_a_k_s_t_r_i_n_g _i_s _e_n_c_o_u_n_t_e_r_e_d _i_n _t_h_e
  22.      _s_t_r_e_a_m.  _T_h_e _r_e_a_d _d_a_t_a _i_s _t_e_r_m_i_n_a_t_e_d _w_i_t_h _a _n_u_l_l _b_y_t_e ('_\\\\_0000') and a
  23.      pointer to the trailing null is returned.  If a _b_r_e_a_k_s_t_r_i_n_g character is
  24.      encountered, the last non-null is the delimiter character that terminated
  25.      the scan.
  26.  
  27.      Note that, except for the fact that the returned value points to the _eeee_nnnn_dddd
  28.      of the read string rather than to the beginning, the call
  29.  
  30.           _bbbb_gggg_eeee_tttt_ssss _((((_bbbb_uuuu_ffff_ffff_eeee_rrrr_,,,, _ssss_iiii_zzzz_eeee_oooo_ffff _bbbb_uuuu_ffff_ffff_eeee_rrrr_,,,, _ssss_tttt_rrrr_eeee_aaaa_mmmm_,,,, _""""_\\\\_nnnn_""""_))))_;;;;
  31.  
  32.      is identical to
  33.  
  34.           _ffff_gggg_eeee_tttt_ssss _((((_bbbb_uuuu_ffff_ffff_eeee_rrrr_,,,, _ssss_iiii_zzzz_eeee_oooo_ffff _bbbb_uuuu_ffff_ffff_eeee_rrrr_,,,, _ssss_tttt_rrrr_eeee_aaaa_mmmm_))))_;;;;
  35.  
  36.      There is always enough room reserved in the buffer for the trailing null.
  37.  
  38.      If _b_r_e_a_k_s_t_r_i_n_g is a null pointer, the value of _b_r_e_a_k_s_t_r_i_n_g from the
  39.      previous call is used.  If _b_r_e_a_k_s_t_r_i_n_g is null at the first call, no
  40.      characters will be used to delimit the string.
  41.  
  42. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  43.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee  _<<<<_llll_iiii_bbbb_gggg_eeee_nnnn_...._hhhh_>>>>
  44.  
  45.      _cccc_hhhh_aaaa_rrrr _bbbb_uuuu_ffff_ffff_eeee_rrrr_[[[[_8888_]]]]_;;;;
  46.      _////_**** _rrrr_eeee_aaaa_dddd _iiii_nnnn _ffff_iiii_rrrr_ssss_tttt _uuuu_ssss_eeee_rrrr _nnnn_aaaa_mmmm_eeee _ffff_rrrr_oooo_mmmm _////_eeee_tttt_cccc_////_pppp_aaaa_ssss_ssss_wwww_dddd _****_////
  47.      _ffff_pppp _==== _ffff_oooo_pppp_eeee_nnnn_((((_""""_////_eeee_tttt_cccc_////_pppp_aaaa_ssss_ssss_wwww_dddd_""""_,,,,_""""_rrrr_""""_))))_;;;;
  48.      _bbbb_gggg_eeee_tttt_ssss_((((_bbbb_uuuu_ffff_ffff_eeee_rrrr_,,,, _8888_,,,, _ffff_pppp_,,,, _""""_::::_""""_))))_;;;;
  49.  
  50. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  51.      _NNNN_UUUU_LLLL_LLLL is returned on error or end-of-file.  Reporting the condition is
  52.      delayed to the next call if any characters were read but not yet
  53.      returned.
  54.  
  55. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  56.      _gggg_eeee_tttt_ssss(3S)
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.